home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / game / 2play / FreeCiv1.7-040.lha / FreeCiv / README < prev    next >
Text File  |  1998-08-14  |  7KB  |  206 lines
  1.                            =========================
  2.                            Freeciv 1.7 documentation
  3.                            =========================
  4.                
  5. This archive contains Freeciv version 1.7, a free Civilization clone for X,
  6. primarily under Unix.  It has support for many players over a network, and the
  7. AI is getting harder to beat every release.
  8.  
  9.  
  10. Compiling and installing:
  11. =========================
  12. Please read the file INSTALL for instructions on how to get Freeciv compiled 
  13. on your machine.  It's really not very hard.
  14.  
  15. Please note: 
  16.  
  17. Freeciv *must* be linked with the _real_ Athena widget library
  18. (libXaw), and not one of the substitutions such as libXaw3d or Nextaw.
  19. If Freeciv is linked with a substitute, the client will crash.
  20.  
  21. This is important because Freeciv currently relies on an Xaw call that
  22. is not present in the (nicer looking) replacement widget sets. If you
  23. wish to use Xaw3d or Nextaw while still being able to play Freeciv, it
  24. is suggested that you use the Xaw-wrappers program.
  25.  
  26.  
  27. Starting a new game:
  28. ===================
  29. Server:
  30.  
  31.   start the server:
  32.   % civserver
  33.  
  34.   Help on command-line options can be obtained with the --help option.
  35.  
  36.   get a list of the available commands with 'h':
  37.   >h
  38.   Available commands: (P=player, M=message, F=file)
  39.   -------------------------------------
  40.   c P      - cut connection to player
  41.   h        - this help
  42.   l        - list players
  43.   q        - quit game and shutdown server
  44.   remove P - fully remove player from game
  45.   score    - show current score
  46.   save F   - save game as file F
  47.   show     - list server options
  48.   help     - help on server options
  49.   meta T   - Set meta-server infoline to T
  50.   ai P     - toggles AI on player
  51.   create P - creates an AI player
  52.   set      - set options
  53.   s        - start game
  54.  
  55.   Now use the 'set' command to set the various variables for the game. 
  56.   You can get a list of the variables with the 'show' command.
  57.   
  58.   You can get option-specific help with: help <option>
  59.  
  60.   For example:
  61.  
  62.   > help xsize
  63.   Affects: Width of map in squares
  64.   Minimum 40, Maximum 100, Default 80
  65.  
  66.   > set xsize 100
  67.   > set ysize 80
  68.  
  69.   This will make the map slightly bigger than the default (80x50).
  70.  
  71. Client:
  72.   Now all the players that want to participate in the game should join. 
  73.   Suppose the server is running on the machine 'io'. Then players would 
  74.   join with a command like:
  75.  
  76.   % civclient -server io
  77.  
  78.   If the Freeciv server is running on the same machine as the Freeciv
  79.   client, then there's no need to specify the server, as the default in
  80.   the dialog box when the client starts will be "localhost", which means
  81.   your computer.
  82.  
  83. Computer Player:
  84.   To start an ai player, you must use the <create> command from the server.  
  85.   For example
  86.   > create HumanKiller
  87.   This will start up an ai player called HumanKiller.  Once the game starts and
  88.   all of the human players have chosen their tribes, the ai players will be
  89.   assigned to tribes.  You can force the ai to play a specific tribe by giving
  90.   it the normal name for that nation's leader.  For example
  91.   > create Ceasar
  92.   Will start an ai player as the Romans.  Unless you take precautions, this
  93.   player can be usurped.
  94.  
  95. Server:
  96.   When everybody has joined (use the (l)ist command to see who's in), the
  97.   server-op starts the game with the (s)start command:
  98.   > s
  99.   starting game.
  100.  
  101. And the game is on!
  102.  
  103. Note:  If you don't want to send information to the metaserver when you start
  104. the game you can give the server the --nometa flag, or just -n for short.
  105. Also, for those people who have used older versions which had ai (eg, 1.5.4),
  106. you no longer have to open a client to get ai to work.
  107.  
  108.  
  109. Playing the game:
  110. =================
  111. The server-op can save the game at any time using the 'save' command,
  112. like so:
  113.  
  114. > save mygame
  115.  
  116. As for the the clients, everything is pretty much as you would expect from
  117. a multiplayer civilization game. That is, the players move at the same time.
  118. There's a turn timeout value, which is by default set to 0 seconds (no
  119. timeout). The server-op can alter this value at any time with the 'set'
  120. command.
  121.  
  122. Have a look at the online help system. All three mouse-buttons are used,
  123. and documented in the help.
  124.  
  125. Players can push the 'Return' key to announce the end of their turn, or just
  126. push the 'Turn done' button.
  127.  
  128. Use the 'Players' dialog to see who has announced their end of turn, and who
  129. you're waiting for.  (Hey feller, are you asleep or what?? ;).
  130.  
  131. Use the input line at the bottom of the window for broadcasting messages to
  132. other players. The server is smart enough to perform "name completion", so
  133. if  you type "pet:", it will pick find a player name that matches the part
  134. of the name you typed.
  135.  
  136. You can send a message to an individual player (say, 'peter') like so:
  137.  
  138.   peter: move that armor away *NOW*!
  139.  
  140.  
  141. Ending the game:
  142. ================
  143. There are two ways in which a game can end:
  144.  
  145. 1) Only one race is left.
  146. 2) The final year is reached.
  147.  
  148. A score-table will be shown in both cases. 
  149. Hint: The server-op can set the final year at run-time by changing the 
  150. end-year variable. This is nice when the winner is obvious, but you don't
  151. want to play through the boring 'cleanup phase'.
  152.  
  153.  
  154. Restoring games:
  155. ================
  156.  
  157. You can restore a saved game by using the '-f' server option, eg:
  158.  
  159.   % civserver -f oursave2001.sav
  160.  
  161. Now the players can join the game:
  162.  
  163.   % civclient -n Alexander -s io
  164.   
  165. Notice how the player-name is specified with the -n option. It's vital
  166. that the player uses the same name if they're to be allowed in.
  167.  
  168. The server-op can now start the game with 's' as usual. Notice that
  169. additional players can join the game even if it has been started.
  170.  
  171.  
  172. Server autostart:
  173. =================
  174. When the maximum number of players have connected, the server auto-starts.
  175. The maximum number of players can be set with the 'maxplayers' variable.
  176.  
  177.  
  178. Bugs:
  179. =====
  180. Should you find any bugs then please send us an email specifying what's
  181. wrong. It might be helpful for us if you specify which OS/version/compiler
  182. you're using.  (Try typing 'uname -a').
  183.  
  184. Bugs should be sent to the freeciv-dev mailing list.  The instructions for
  185. doing this can be found at the page below.
  186.  
  187. Homepage:
  188. =========
  189. We maintain a homepage for the game at:
  190.  
  191.   http://www.freeciv.org
  192.  
  193. You should check out the page, as it contains much more information than
  194. this file and the online help. This is also where we'll inform people about 
  195. new releases/bugs/fixes/competitions, etc.
  196.  
  197.  
  198. New Releases:
  199. =============
  200. New releases will first be made available at:
  201.   ftp://www.freeciv.org/pub/freeciv
  202.  
  203. Have fun and now go give 'em hell!
  204.  
  205.  
  206.